package cn.iocoder.yudao.module.ao.service.vocationalclassschedule;

import java.util.*;
import javax.validation.*;
import cn.iocoder.yudao.module.ao.controller.admin.vocationalclassschedule.vo.*;
import cn.iocoder.yudao.module.ao.dal.dataobject.vocationalclassschedule.VocationalClassScheduleDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

/**
 * 中高技班级课 Service 接口
 *
 * @author 禾安
 */
public interface VocationalClassScheduleService {

    /**
     * 创建中高技班级课
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Integer createVocationalClassSchedule(@Valid VocationalClassScheduleSaveReqVO createReqVO);

    /**
     * 更新中高技班级课
     *
     * @param updateReqVO 更新信息
     */
    void updateVocationalClassSchedule(@Valid VocationalClassScheduleSaveReqVO updateReqVO);

    /**
     * 删除中高技班级课
     *
     * @param id 编号
     */
    void deleteVocationalClassSchedule(Integer id);

    /**
    * 批量删除中高技班级课
    *
    * @param ids 编号
    */
    void deleteVocationalClassScheduleListByIds(List<Integer> ids);

    /**
     * 获得中高技班级课
     *
     * @param id 编号
     * @return 中高技班级课
     */
    VocationalClassScheduleDO getVocationalClassSchedule(Integer id);

    /**
     * 获得中高技班级课分页
     *
     * @param pageReqVO 分页查询
     * @return 中高技班级课分页
     */
    PageResult<VocationalClassScheduleDO> getVocationalClassSchedulePage(VocationalClassSchedulePageReqVO pageReqVO);

    /**
     * 导入中高技班级课
     *
     * @param importVocationalClassSchedules 导入的中高技班级课列表
     * @param updateSupport 是否支持更新
     * @return 导入结果
     */
    VocationalClassScheduleImportRespVO importVocationalClassScheduleList(List<VocationalClassScheduleImportExcelVO> importVocationalClassSchedules, Boolean updateSupport);

    /**
     * 清理无效的教师数据
     */
    void cleanInvalidTeacherData();

    /**
     * 清理教师信息中的无效科目（如"班主任"等职务）
     */
    void cleanInvalidTeacherSubjects();

    /**
     * 清理无效的课程数据
     */
    void cleanInvalidCourseData();

    /**
     * 强制提取所有可能的教师姓名
     */
    void forceExtractAllPossibleTeachers();

    /**
     * 测试基于位置的教师提取逻辑
     */
    void testPositionBasedTeacherExtraction();

}